home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_cvs.idb / usr / freeware / catman / a_man / cat8 / cvsbug.Z / cvsbug
Encoding:
Text File  |  1999-04-16  |  10.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      CCCCVVVVSSSSBBBBUUUUGGGG((((1111))))         FFFFeeeebbbbrrrruuuuaaaarrrryyyy 1111999999993333 ((((xxxxVVVVEEEERRRRSSSSIIIIOOOONNNNxxxx))))         CCCCVVVVSSSSBBBBUUUUGGGG((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       cvsbug - send    problem    report (PR) about CVS to a central
  10.       support site
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       ccccvvvvssssbbbbuuuugggg [ _s_i_t_e    ] [ ----ffff _p_r_o_b_l_e_m-_r_e_p_o_r_t ]    [ ----tttt _m_a_i_l-_a_d_d_r_e_s_s ]
  14.           [ ----PPPP ] [ ----LLLL ]    [ --------rrrreeeeqqqquuuueeeesssstttt----iiiidddd ] [ ----vvvv ]
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.       ccccvvvvssssbbbbuuuugggg is a tool used    to submit _p_r_o_b_l_e_m _r_e_p_o_r_t_s (PRs)    to a
  18.       central support site.     In most cases the correct _s_i_t_e    will
  19.       be the default.  This    argument indicates the support site
  20.       which    is responsible for the category    of problem involved.
  21.       Some sites may use a local address as    a default. _s_i_t_e    values
  22.       are defined by using the aaaalllliiiiaaaasssseeeessss(5).
  23.  
  24.       ccccvvvvssssbbbbuuuugggg invokes an editor on a    problem    report template    (after
  25.       trying to fill in some fields    with reasonable    default
  26.       values).  When you exit the editor, ccccvvvvssssbbbbuuuugggg sends the
  27.       completed form to the    _P_r_o_b_l_e_m    _R_e_p_o_r_t _M_a_n_a_g_e_m_e_n_t _S_y_s_t_e_m
  28.       (GGGGNNNNAAAATTTTSSSS) at a central support site.  At the support site, the
  29.       PR is    assigned a unique number and is    stored in the GGGGNNNNAAAATTTTSSSS
  30.       database according to    its category and submitter-id.    GGGGNNNNAAAATTTTSSSS
  31.       automatically    replies    with an    acknowledgement, citing    the
  32.       category and the PR number.
  33.  
  34.       To ensure that a PR is handled promptly, it should contain
  35.       your (unique)    _s_u_b_m_i_t_t_e_r-_i_d and one of    the available
  36.       _c_a_t_e_g_o_r_i_e_s to    identify the problem area.  (Use ````ccccvvvvssssbbbbuuuugggg ----LLLL''''
  37.       to see a list    of categories.)
  38.  
  39.       The ccccvvvvssssbbbbuuuugggg template at your site should already be
  40.       customized with your submitter-id (running `iiiinnnnssssttttaaaallllllll----ssssiiiidddd
  41.       _s_u_b_m_i_t_t_e_r-_i_d'    to accomplish this is part of the installation
  42.       procedures for ccccvvvvssssbbbbuuuugggg).  If this hasn't been done, see your
  43.       system administrator for your    submitter-id, or request one
  44.       from your support site by invoking ````ccccvvvvssssbbbbuuuugggg --------rrrreeeeqqqquuuueeeesssstttt----iiiidddd''''.... If
  45.       your site does not distinguish between different user    sites,
  46.       or if    you are    not affiliated with the    support    site, use
  47.       ````nnnneeeetttt''''    for this field.
  48.  
  49.       The more precise your    problem    description and    the more
  50.       complete your    information, the faster    your support team can
  51.       solve    your problems.
  52.  
  53.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  54.       ----ffff _p_r_o_b_l_e_m-_r_e_p_o_r_t
  55.            specify a file (_p_r_o_b_l_e_m-_r_e_p_o_r_t) which already contains
  56.            a complete problem report.  ccccvvvvssssbbbbuuuugggg sends    the contents
  57.            of the file without invoking the    editor.     If the    value
  58.            for _p_r_o_b_l_e_m-_r_e_p_o_r_t is ````----'''', then ccccvvvvssssbbbbuuuugggg reads from
  59.            standard    input.
  60.  
  61.  
  62.  
  63.      Page 1                          (printed 2/3/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      CCCCVVVVSSSSBBBBUUUUGGGG((((1111))))         FFFFeeeebbbbrrrruuuuaaaarrrryyyy 1111999999993333 ((((xxxxVVVVEEEERRRRSSSSIIIIOOOONNNNxxxx))))         CCCCVVVVSSSSBBBBUUUUGGGG((((1111))))
  71.  
  72.  
  73.  
  74.       ----tttt _m_a_i_l-_a_d_d_r_e_s_s
  75.            Change mail address at the support site for problem
  76.            reports.     The default _m_a_i_l-_a_d_d_r_e_s_s is the address used
  77.            for the default _s_i_t_e.  Use the _s_i_t_e argument rather
  78.            than this option    in nearly all cases.
  79.  
  80.       ----PPPP   print the form specified    by the environment variable
  81.            PPPPRRRR____FFFFOOOORRRRMMMM on standard output.  If PPPPRRRR____FFFFOOOORRRRMMMM is not set,
  82.            print the standard blank    PR template.  No mail is sent.
  83.  
  84.       ----LLLL   print the list of available categories.    No mail    is
  85.            sent.
  86.  
  87.       --------rrrreeeeqqqquuuueeeesssstttt----iiiidddd
  88.            sends mail to the default support site, or _s_i_t_e if
  89.            specified, with a request for your _s_u_b_m_i_t_t_e_r-_i_d.     If
  90.            you are not affiliated with _s_i_t_e, use a _s_u_b_m_i_t_t_e_r-_i_d of
  91.            nnnneeeetttt'.
  92.  
  93.       ----vvvv   Display the ccccvvvvssssbbbbuuuugggg version number.
  94.  
  95.       Note:    use ccccvvvvssssbbbbuuuugggg to submit problem reports rather than
  96.       mailing them directly.  Using    both the template and ccccvvvvssssbbbbuuuugggg
  97.       itself will help ensure all necessary    information will reach
  98.       the support site.
  99.  
  100.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  101.       The environment variable EEEEDDDDIIIITTTTOOOORRRR specifies the    editor to
  102.       invoke on the    template.
  103.       default:  vvvviiii
  104.  
  105.       If the environment variable PPPPRRRR____FFFFOOOORRRRMMMM is set, then its value
  106.       is used as the file name of the template for your problem-
  107.       report editing session.  You can use this to start with a
  108.       partially completed form (for    example, a form    with the
  109.       identification fields    already    completed).
  110.  
  111.      HHHHOOOOWWWW TTTTOOOO FFFFIIIILLLLLLLL OOOOUUUUTTTT AAAA PPPPRRRROOOOBBBBLLLLEEEEMMMM RRRREEEEPPPPOOOORRRRTTTT
  112.       Problem reports have to be in    a particular form so that a
  113.       program can easily manage them.  Please remember the
  114.       following guidelines:
  115.  
  116.       +o  describe only oooonnnneeee pppprrrroooobbbblllleeeemmmm with each problem report.
  117.  
  118.       +o  For follow-up mail, use the same subject line as the one
  119.          in    the automatic acknowledgent. It    consists of category,
  120.          PR    number and the original    synopsis line.    This allows
  121.          the support site to relate    several    mail messages to a
  122.          particular    PR and to record them automatically.
  123.  
  124.       +o  Please try    to be as accurate as possible in the subject
  125.          and/or synopsis line.
  126.  
  127.  
  128.  
  129.      Page 2                          (printed 2/3/99)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      CCCCVVVVSSSSBBBBUUUUGGGG((((1111))))         FFFFeeeebbbbrrrruuuuaaaarrrryyyy 1111999999993333 ((((xxxxVVVVEEEERRRRSSSSIIIIOOOONNNNxxxx))))         CCCCVVVVSSSSBBBBUUUUGGGG((((1111))))
  137.  
  138.  
  139.  
  140.       +o  The subject and the synopsis line are not confidential.
  141.          This is because open-bugs lists are compiled from them.
  142.          Avoid confidential    information there.
  143.  
  144.       See the GNU IIIInnnnffffoooo file    ccccvvvvssssbbbbuuuugggg....iiiinnnnffffoooo or the document _R_e_p_o_r_t_i_n_g
  145.       _P_r_o_b_l_e_m_s _W_i_t_h    _c_v_s_b_u_g for detailed information    on reporting
  146.       problems
  147.  
  148.      HHHHOOOOWWWW TTTTOOOO SSSSUUUUBBBBMMMMIIIITTTT TTTTEEEESSSSTTTT    CCCCAAAASSSSEEEESSSS,,,, CCCCOOOODDDDEEEE,,,, EEEETTTTCCCC....
  149.       Submit small code samples with the PR.  Contact the support
  150.       site for instructions    on submitting larger test cases    and
  151.       problematic source code.
  152.  
  153.      FFFFIIIILLLLEEEESSSS
  154.       /tmp/p$$     copy of PR used in editing session
  155.       /tmp/pf$$    copy of empty PR    form, for testing purposes
  156.       /tmp/pbad$$  file for    rejected PRs
  157.  
  158.      IIIINNNNSSSSTTTTAAAALLLLLLLLAAAATTTTIIIIOOOONNNN AAAANNNNDDDD CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN
  159.       See IIIINNNNSSSSTTTTAAAALLLLLLLL for installation instructions.
  160.  
  161.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  162.       ggggnnnnaaaattttssss(l), qqqquuuueeeerrrryyyy----pppprrrr(1), eeeeddddiiiitttt----pppprrrr(1), ggggnnnnaaaattttssss(8), qqqquuuueeeeuuuueeee----pppprrrr(8),
  163.       aaaatttt----pppprrrr(8), mmmmkkkkccccaaaatttt(8), mmmmkkkkddddiiiisssstttt(8).
  164.  
  165.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  166.       Jeffrey Osier, Brendan Kehoe,    Jason Merrill, Heinz G.    Seidl
  167.       (Cygnus Support)
  168.  
  169.      CCCCOOOOPPPPYYYYIIIINNNNGGGG
  170.       Copyright (c)    1992, 1993 Free    Software Foundation, Inc.
  171.  
  172.       Permission is    granted    to make    and distribute verbatim    copies
  173.       of this manual provided the copyright    notice and this
  174.       permission notice are    preserved on all copies.
  175.  
  176.       Permission is    granted    to copy    and distribute modified
  177.       versions of this manual under    the conditions for verbatim
  178.       copying, provided that the entire resulting derived work is
  179.       distributed under the    terms of a permission notice identical
  180.       to this one.
  181.  
  182.       Permission is    granted    to copy    and distribute translations of
  183.       this manual into another language, under the above
  184.       conditions for modified versions, except that    this
  185.       permission notice may    be included in translations approved
  186.       by the Free Software Foundation instead of in    the original
  187.       English.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                          (printed 2/3/99)
  196.  
  197.  
  198.  
  199.